home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / MUSIC / WAVCNV1 / WAVCONV.TXT < prev   
Text File  |  1992-06-27  |  10KB  |  217 lines
  1.       WavConv  Version 1.0 - Copyright 1992 James M. Curran
  2.  
  3. Description: 
  4.  
  5.     WavConv is a DOS utility for converting 8-bit sound files among 
  6. many of the most common PC formats.  It will convert a file from or 
  7. to any of the following file types:  Covox SpeechThing / VoiceMaster 
  8. (VMFs),  Microsoft Windows 3.1 (WAVs),  DSound 2.0 (SNDs), 
  9. SoundTool/ Wired for Sound (also SNDs but a different format),  
  10. SoundBlaster (VOCs), and straight 8-bit data (which Covox calls 
  11. VMDs and DSound calls SOUs).  
  12.  
  13.     WavConv also allows several parameters of the sound file to be added 
  14. or changed during the conversion, notably the Sampling frequency, 
  15. and the Title of the sound clip. 
  16.  
  17.     Finally, WavConv will list the  following technical information about 
  18. the file: File size, Sampling frequency, Play time and Title.   (This can 
  19. be displayed without building a new file)
  20.  
  21.  
  22.  
  23. Syntax:
  24.     WavConv <infile name> [<outfile name>] [<switches>]
  25.  
  26. <infile>  - The name of the existing file you wish converted to a new format. 
  27. This file is not altered; a second file is created.  the extension defaults 
  28. to .VMD if not given.
  29.  
  30. <outfile> - The name of the file to be created.  It also indicates, by its 
  31. extension,  what type of file should be created.  If not given, defaults 
  32. to basename of infile with the extension indicated by the /T switch.
  33.  
  34.  
  35.  
  36. /Tn    Where n indicates what file type for the output file,  and is one of the 
  37. following:
  38.     V   - VMF       (Covox VoiceMaster File)
  39.     W   - WAV       (Windows WaveForm file)
  40.     S   - SND       (SoundTool/Wired for Sound file)
  41.     D   - SND       (DSound Sound File)
  42.     C   - VOC       (SoundBlaster Sound file)
  43.     X   - VMD/SOU  (straight 8-bit data - no header)
  44.  
  45.     If  a /T switch is not given, the type will default to that indicated by the 
  46. outfile extension.
  47.  
  48. NOTE:
  49. o         Either a Outfile name or a /T switch  MUST be given.
  50. o    If both an Outfile and a /T switch is given, they must be for 
  51. compatible types.
  52. o    If  an outfile extension of .SND is used without a /T switch ,  "/TS" 
  53. (SoundTool format) is assumed.
  54. o    If a switch of /TX is given without an outfile, an extension of  ".VMD" 
  55. is used.
  56.  
  57. Additional Switches:
  58.  
  59. /Fnnnnn   - Where nnnnn is the frequency (in Hz) that the file was recorded  
  60. at.  In most cases, this switch is NOT needed as this information is 
  61. contained in the infile. However,  VMDs and SOUs do not hold this 
  62. value, so to build a new file out of an VMD, this switch must be given.  
  63. The /F switch also allows you to overrule the value stored in the infile. 
  64.  
  65. /Nnnnnnn  - Where nnnnn is the Name of the sound clip.  May be up to 96           
  66. characters long. USE UNDERSCORES INSTEAD OF SPACES. They 
  67. will be changed back into spaces internally.    
  68.     Names are: 
  69.     o    REQUIRED for SNDs used with Wired for Sound;  
  70.     o    Formally standardized in VOCs, 
  71.     o    Informally standardized in WAVs;  
  72.     o    Non standardized in VMFs; 
  73.     o    Not stored at all in SOUs, VMDs, and DSound SNDs
  74.  
  75.  
  76.  
  77.     
  78. /I    Don't convert, just display file information.  Normally, as it's 
  79. converting the file, WavConv will display the filename, file size, 
  80. frequency, title, and approximate playing time of the sound clip.  By 
  81. specifying the /I switch, this information is displayed about the infile, 
  82. and no conversion is attempted.
  83.  
  84. /?    Displays a short synopses of the command syntax.
  85.  
  86.   Switches for writing Covox VMF files only:
  87.  
  88. /Sn    Silence threshold of recording (0-5). default=0.
  89.  
  90. /Rnnn    Where nnn is the recording rate from 0-255. If omitted or 0, the default 
  91. value of 132 is used.  This value is also used for the playback rate 
  92. unless the /P switch is used.
  93.  
  94. /Pnnn    Where nnn is the playback rate from 0-255.  If omitted or 0, the record 
  95. value is used.
  96.  
  97.   For writing WFSound SND files only:
  98.  
  99. /Vnnn    - Volume. Default = 10.
  100. /Hnnn    - Shift.  Default = 4.
  101.  
  102.  
  103. Special Notes:
  104.  
  105. WAV Files:
  106.     WAV files are used by Microsoft Windows 3.1.  The format was 
  107. detailed in Charles Petzold's Environments column in the February 
  108. 11th, 1992 issue of PC Magazine.    WavConv can only read the first 
  109. "data" chunk of the file.   As each chunk can be up to 16 megabytes 
  110. long this should not pose a significant limitation. WavConv will only 
  111. write one "data" chunk.  For titles, WavConv employs the method 
  112. described in that PC magazine column, specifically, a "INFO" chunk, 
  113. with an "INAM" subchunk.  (Mr. Petzold has said that this is a 
  114. standard, if not widespread, method).   For WavConv to be able to 
  115. read a title from a WAV file, the "INFO" chunk must be the second 
  116. chunk in the file, immediately following the "data" chunk. (The 
  117. "INAM" sub-chunk may be anywhere in the "INFO" chunk).  If a title 
  118. is to be placed on a WAV file, WavConv will always write the "INFO" 
  119. chuck second, with "INAM" as it's only subchunk.
  120.  
  121. SND files (Wired for Sound / SoundTool)
  122.     SND files of this type were designed by  Martin Hepperle for use with 
  123. his SoundTool program, which in turn used Aaron Wallace's DSound .  
  124. They were later used by Wallace in Artisoft's Wired for Sound.  Their 
  125. format is documented in both those packages.  These are the only files 
  126. that contain a specifically designated title field.  Wired for Sound 
  127. requires that a title be present in the file for the sound clip  to be listed  
  128. with the others used by the program.  If converting a file from a 
  129. different format to an SND file with the intention of using it with 
  130. Wired for Sound,  make sure it either has a title (very few do), or use 
  131. the /N switch to add a title.  (Use the /I switch to check for a title 
  132. before you do the actual conversion).
  133.  
  134. SND files (DSound format)
  135.     SND files of this type are the obsolete precursor to the SoundTool 
  136. SND format.   These were originally designed by Aaron Wallace for 
  137. his DSound package, but their use is discouraged these days.  They do 
  138. NOT support a title at all.  Any title on the infile will be lost when 
  139. converting to an SND file.  They are also difficult for WavConv to 
  140. positively identify, so misidentification is possible if an SND is the 
  141. infile.  SPECIAL NOTE: Attempting to create a SoundTool  SND file 
  142. from a DSound SND file will fail, if both files have the same base 
  143. name (since the extension are the same as well).  This is the only 
  144. instance where the infile is in jeopardy (it would probably be erased). 
  145. For example:
  146.         WAVCONV  myfile.snd /TS            NO!!
  147.         WAVCONV  myfile.snd  yourfile.snd          OK
  148.  
  149.  
  150. VOC files
  151.     VOC files were designed by Creative Media for use with their 
  152. SoundBlaster board, and is documented by them.  Instead of storing 
  153. the actual sampling frequency, VOCs only store a one byte code which 
  154. approximates it.  This often varies slightly from the actual frequency.  
  155. When converting from a VOC to some other format, you may wish to 
  156. adjust the sampling frequency, by using the /F switch.  The /I switch 
  157. will have WavConv tell you  the frequency stored in the VOC file.  
  158. WavConv will only process the first data block of the file. (Few have 
  159. more than one). WavConv assumes when reading a VOC file, that if 
  160. the second block is a type 05 (ASCII Text) then it contains the title for 
  161. the file.  This is where WavConv stores the title, when it writes a VOC 
  162. file.
  163.     
  164. VMF files:
  165.     VMF files were designed by Covox, for use by their Voice Master 
  166. board, and is documented by them.  Like the VOC files,  instead of 
  167. storing the actual sampling frequency, VMFs only store a one byte 
  168. code which approximates it.  This often varies slightly from the actual 
  169. frequency.  When converting from a VMF to some other format, you 
  170. may wish to adjust the sampling frequency, by using the /F switch.  
  171. The /I switch will have WavConv tell you  the frequency stored in the 
  172. VMF file.  As originally design VMFs had no provisions for a file title.  
  173. However, WavConv annexes a piece of an empty "reserved for future 
  174. use" block for this purpose.
  175.  
  176. VMD & SOU files.
  177.     These are the extensions used by, respectively, Covox and DSound, 
  178. for files which are pure data with no header information.  To create a 
  179. files out of one of these types,  you MUST specify the sampling rate 
  180. using the /F switch.   WavConv will also create these types of file, 
  181. however, all on the operating parameters stored in the infile will be 
  182. lost.
  183.  
  184.  
  185.  
  186. Fine Print:
  187.     This program is copyright 1992, by James M. Curran.  It is being 
  188. released to the general public free of charge, for the betterment of 
  189. modern civilization.   It is being released as "Gollyware", that is, you 
  190. are required to say "Golly, James is a nice guy" every time you use it.
  191.  
  192.     All comments, bug reports, future enhancement requests,  death 
  193. threats, and/or offers of employment generated by program should be 
  194. directed to me at:
  195.  
  196.         James M. Curran
  197.         18 John St., Apt 2B
  198.         Bloomfield, NJ 07003-5149
  199.  
  200.         CompuServe  ID: [72261,655]
  201.  
  202.     If you're interested in a reply, it's best to use CISmail.  That I check 
  203. and respond to nearly every day.    Responses via the US Mail could 
  204. take days (or months!).
  205.  
  206.     As is traditional, I disavow any warranties, either expressed or implied.  
  207. ("Whatta Would for Nothin' ?  Rubber Biscuit ?")
  208.  
  209.     I'm particularly interested in adding as many different filetypes as 
  210. possible to this.  If you know of a sound file type in use that not 
  211. included here, and know the internal format of it (or know where I 
  212. can find it), please send that information in...
  213.  
  214. Release History:
  215.     23-Jun-92  Ver 1.0 - Handles VOCs, VMFs, SNDs, SOU, and VMDs,
  216.  
  217.